PySide/de

Other languages:
Pivy
Schnittstellen erstellen
Index

Einleitung

Die PySide-Bibliothek ist ein Python-Wrapper für den plattformübergreifenden GUI-Werkzeugsatz Qt. FreeCAD setzt Qt als seinen Hauptwerkzeugsatz für die Benutzerschnittstelle (GUI) ein. Qt selbst ist mehr als nur ein GUI-Werkzeugsatz, es ist eine Sammlung von C++ Bibliotheken für viele unterschiedliche Aufgaben; man kann beispielsweise mit Komponenten der Bibliothek netzwerken, und durch Pyside kann auf alles mit Python zugegriffen werden. Jede grafische Oberfläche, die in C++ erstellt werden kann, kann auch in Python erstellt und modifiziert werden. Ein Vorteil der Verwendung von Python ist, dass Qt-Oberflächen entwickelt und live getestet werden können, da wir die Quelldateien nicht kompilieren müssen.

Die empfohlene Methode zum Importieren von PySide (jeder Version) in FreeCAD ist: 

from PySide import QtCore, QtGui, QtWidgets

Qt & PySide-Versionen

Mit PySide erstellte Beispiele. Links: ein einfacher Dialog. Rechts: ein komplexerer Dialog mit Diagrammen.

Anfang

FreeCAD und PySide

Die ursprüngliche Idee hinter FreeCAD war es, Cas.CADE (geometrischer Kernel), Qt (GUI-Toolkit) und Python zusammenzuführen, um ein freies parametrisches 3D-CAD-Programm mit integrierter Skript-Engine zu schaffen. Dies war in den frühen 2000er Jahren, also vor der Existenz von PySide, sodass in den ersten zehn Jahren des Bestehens von FreeCAD ein anderer Wrapper – PyQt – verwendet wurde. PySide wurde entwickelt, um Lizenzprobleme mit PyQt zu lösen, und 2013 erfolgte die Umstellung von FreeCAD auf PySide (commit 1dc122dc9a).

Wenn man wissen möchte, welche Qt-Version die Installation verwendet, findet man im Dialog Über FreeCAD eine Liste der Versionen, in denen Qt enthalten ist.

Für weitere Informationen siehe:

Wird FreeCAD installiert, erhält man sowohl Qt als auch ein passendes PySide als Teil des Pakets. Wenn man selbst kompiliert, muss man überprüfen, ob passende Versionen diese beiden Bibliotheken installiert sind, damit FreeCAD korrekt läuft. Natürlich wird PySide nur funktionieren, wenn Qt vorhanden ist.

Anfang

Kompatibilität mit verschieden Versionen

Der Hauptunterschied zwischen den Bibliotheken PySide und den nachfolgenden PySide2 und PySide6 besteht im Namensraum. PySide (Qt4) hat die Hauptnamensräume QtGui und QtCore, während PySide2 (Qt5) und PySide6 (Qt6) den zusätzlichen Namensraum QtWidgets eingeführt haben, in dem sich nun alle Widgets befinden, die zuvor im QtGui-Namensraum lagen.

Der Ansatz von FreeCAD zur Handhabung der verschiedenen Versionen von Qt/PySide besteht darin, sie alle als PySide zu bezeichnen, was eigentlich als PySideX verstanden werden sollte. Es spielt keine Rolle, welche Qt/PySide-Version installiert ist, sie werden alle mit PySide importiert.

Ein Shim verwaltet die Unterschiede zwischen den Versionen. Dieser PySide Shim befindet sich im Verzeichnis Ext/ einer für Qt5/Qt6 kompilierten FreeCAD-Installation. 

/usr/share/freecad/Ext/PySide

Dieses Modul importiert einfach die erforderlichen Klassen aus PySide2/6, bringt sie aber im Namensraum von PySide unter. Diese Herangehensweisen wurde ausgewählt, da sie, von Qt4 aus betrachtet, eine Rückwärtskompatibilität ermöglicht. 

PySide2.QtCore -> PySide.QtCore
PySide2.QtGui -> PySide.QtGui
PySide2.QtWidgets -> PySide.QtWidgets
PySide2.QtSvg -> PySide.QtSvg
PySide2.QtUiTools -> PySide.QtUiTools

Aus diesem Grund sind die Klassen der PySide2.QtWidgets auch im Namensraum PySide.QtGui untergebracht. 

PySide2.QtWidgets.QCheckBox -> PySide.QtGui.QCheckBox

Aber der derzeit empfohlene Weg ist die Verwendung der moderneren Namespacing-Variante. 

from PySide import QtCore, QtGui, QtWidgets

my_check_box = QtWidgets.QCheckBox()

Anfang

Beispiele für die Verwendung von PySide

Die Beispiele von PySide sind in 3 Teile unterteilt, die sich nach dem Grad der Exposition gegenüber PySide, Python und den FreeCAD Interna unterscheiden. Die erste Seite gibt einen Überblick über PySide; die zweite und dritte Seite sind meist Code Beispiele auf verschiedenen Niveaus.

Es wird erwartet, dass diese Beispiele für den Anfang nützlich sind, und danach kann der Benutzer andere Ressourcen online oder die offizielle Dokumentation hinzuziehen.

Anfang

Dokumentation

Es gibt einige Unterschiede in der Behandlung von Widgets zwischen den unterschiedlichen Versionen. Programmierer sollten sich dieser Inkompatibilitäten bewusst sein und die offizielle Dokumentation konsultieren, wenn etwas auf einer bestimmten Plattform nicht wie erwartet funktioniert. Wenn auch selten, kann es manchmal erforderlich sein, versionsabhängige Aufrufe über If-Abfragen zu erstellen.

Die PySide-Dokumentation bezieht sich auf die Klassen im Python-Stil; da Qt jedoch ursprünglich eine C++ Bibliothek ist, sollten dieselben Informationen auch in der entsprechenden C++ Referenz vorhanden sein.

Anfang

Pivy
Schnittstellen erstellen
Index
Power user documentation